home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / util / cli / Randomizer.lha / Random / ReadMeFirst < prev   
Text File  |  1997-07-16  |  4KB  |  100 lines
  1. Short introduction to Randomizer V1.1
  2. =====================================
  3.  
  4.  
  5.  **** <-- The four stars indicate a change from V1.0 to V1.1
  6.  
  7.  
  8. 0. If you are not familiar in working with a shell, forget this program !!!
  9.  
  10. 1. Find the file Randomizer.
  11.  
  12. 2. Copy it to C: for your convenience.
  13.  
  14. 3. It takes 2 (optional) parameters: HI or HIGH, and LO or LOW. You can use
  15.    both the english or the american spelling, you can even mix it.
  16.  
  17.    a. HI/HIGH limits the random number to an upper bound. Do not overdo it,
  18.       it generates it's numbers from the timer ! You are totally safe, if
  19.       you keep it below 500 000 000, provided, your clock is set to the
  20.       actual time and not at some random value. It has a default value of
  21.       1 (one).
  22.  
  23.  **** There is a theoretical problem, if you never used your Amiga before,
  24.       and if it has no hardware clock (like a stock A1200): AmigaDOS saves
  25.       the time of the last session to the boot disk. If this value is zero,
  26.       because you never used your boot disk before. your system time is very
  27.       low. With Randomizer Version 1.1 you can safely specify a MAX value
  28.       of 999999, because it now adds system seconds and microseconds (Thanx
  29.       go to Jens Granseuer, who suggested this).
  30.  
  31.    b. LO/LOW raises the lower bound to the specified value. You NEVER get
  32.       a number below this value. If the timer generated a value below it,
  33.       it is lifted to this low value. Looking closer, this means, that there
  34.       is a much higher percentage of this low value, than of any other
  35.       number. If you use the LOW keyword, you BREAK the RANDOMNESS. By
  36.       default, it has a value of 0 (null), and I advise you, to leave it
  37.       there !
  38.  
  39.  **** The problem described above is finally solved. Randomizer just pulls
  40.       down the range defined by HIGH and LOW to zero, creates a random number
  41.       and adds the LOW value again.
  42.  
  43.  **** c. Randomizer now also checks for a LOW value equal to or higher than
  44.       HIGH to avoid Division By Zero. Thanx again to Jens Granseuer.
  45.       Additionally I added the error message
  46.       "LOW >= HIGH : <ERROR 115>", where <ERROR 115> is automagically
  47.       replaced by the OS with a string describing the error in detail.
  48.  
  49. 4. Where is the number, then ? As the program is intended for use in scripts,
  50.    it seemed most convenient for me, to store it in a local shell variable.
  51.    So it creates a new variable by the name of "RANDOM", which holds the
  52.    random number. You can easily use it with "eval", tag it before or behind
  53.    filenames, and so on.
  54.  
  55. 5. How can I get rid of the number after use ? Simply type "Unset RANDOM" !
  56.  
  57. 6. Can you give me an example ? Yes, here it is. Let's say, you have a
  58.    backdrop picture located in SYS:Prefs/Patterns named "BackDropPic.iff".
  59.    Your WBPattern preferences settings include this path. Furthermore you
  60.    have 25 other pictures to be used as backdrops randomly, which are named
  61.    "picture.0" to "picture.24". Then you would write something like this in
  62.    your startup sequence:
  63.  
  64.    ...
  65.    C:AddDataTypes
  66.    ...
  67.  
  68.    ;example starts here
  69.  
  70.    C:Randomizer HIGH 24
  71.    C:Copy SYS:Prefs/Patterns/picture.$RANDOM SYS:Prefs/Patterns/BackDropPic.iff QUIET
  72.    Unset RANDOM
  73.  
  74.    ;example ends here
  75.  
  76.    ...
  77.    C:IPrefs
  78.    ...
  79.  
  80.    Please notice, that you would want to practise this example between the
  81.    AddDataTypes and IPrefs call !
  82.    Also note, that "Unset" is NOT A PROGRAM LOCATED IN C: !!! It is shell
  83.    private !
  84.    Further note, that the above example overwrites whatever the file
  85.    "BackDropPic.iff" is. If it was a 26th picture, you have lost it !
  86.  
  87. 7. I would kindly like to appreciate you to read the copyright files provided
  88.    in this archive. If there are none, DO NOT USE THE PROGRAM ! Mail me for
  89.    an original copy. I am releasing the sourcecode, too, so there might be
  90.    fakes or even viruses ! If in doubt, email me for the original:
  91.  
  92.    T.Heinrich@t-online.de
  93.  
  94. 8. Don't dump your Amiga. It still is the best home computer there is !
  95.  
  96. Thomas "Hoin" Heinrich
  97. April, 5th 1997
  98.  
  99.  **** V1.1: July, 16th 1997
  100.